home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / showu310.zip / SHOWUSER.DOC < prev    next >
Text File  |  1991-04-03  |  11KB  |  272 lines
  1.  
  2.  
  3.         SHOWUSER: v3.10                                   by Stephen de Plater
  4.         April 3, 1991                                         GT Network 302/1
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                        SHOWUSER
  13.                                  by Stephen de Plater
  14.                                GT Network Address: 302/1
  15.                                  Voice: +61 2 977-3075
  16.                                  Data: +61 2 977-2013
  17.  
  18.  
  19.  
  20.  
  21.         ======================================================================
  22.         0.                           REVISION LIST
  23.         ======================================================================
  24.  
  25.         VERSION:  Release Date:       Comments:
  26.         -------   ------------        --------------------------------------
  27.         1.00      January 16, 1989    Initial release.
  28.  
  29.         1.10      March 16, 1989      Traps  for  today only,  revised signon,
  30.                                       various minor adjustments.
  31.  
  32.         3.00      June 22, 1990       (Yes it  is a big  jump <grin>.  Version
  33.                                       2.x was never released.)
  34.  
  35.                                       Total  rewrite.    More  information  is
  36.                                       shown and SHOWUSER is now independent of
  37.                                       any associated programs (you  don't need
  38.                                       to run anything else  to make it work as
  39.                                       you  did  with version  1.x).  Also this
  40.                                       version  introduces  a  port  to  a  new
  41.                                       compiler (Turbo C++).
  42.  
  43.         3.10      April 3, 1991       Deleted  users  are  no   longer  named.
  44.                                       Instead  the  message  "All records  for
  45.                                       this   user   have   been  PURGED!"   is
  46.                                       displayed.  The /C parameter was added.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                      >> page 1 <<
  56.  
  57.         SHOWUSER: v3.10                                   by Stephen de Plater
  58.         April 3, 1991                                         GT Network 302/1
  59.  
  60.  
  61.  
  62.         ======================================================================
  63.         1.                             COPYRIGHT
  64.         ======================================================================
  65.  
  66.         SHOWUSER is not placed in the Public Domain. The copyright is retained
  67.         and the software is provided on licence:
  68.  
  69.         You are  free to use and make as many  copies of these programs as you
  70.         wish. You may also give them away to anyone who wants it, provided:
  71.  
  72.         1.   No fee is charged.
  73.         2.   This archive is distributed intact.
  74.         3.   You register the package with an OzNet registration centre.
  75.  
  76.  
  77.         ======================================================================
  78.         2.                           REGISTRATION
  79.         ======================================================================
  80.  
  81.         A  new  registration   scheme  now  applies  to  all  OZNET  software.
  82.         Regardless  of any  previous registration,  this program  now requires
  83.         individual installation for each BBS using it.
  84.  
  85.         There  is  still NO  fee  involved  at all.  DO  NOT  send any  money!
  86.         Registration  simply  involves obtaining  from  me  a CRC  code  which
  87.         matches your  BBS  name.    You  may  do this  at  any  of  the  OZNET
  88.         registration centres:
  89.  
  90.                   Kangaroo Korner          302/001   Stephen de Plater
  91.                   The Black Hole           302/003   Ken Thompson
  92.                   Control Systems          071/001   Ed Cavender
  93.                   Gidget's Domain          081/005   Jack Hazel
  94.                   Fuzzy Logic              050/018   Phill Piddell
  95.                   Geno's Place             044/003   Gene Newcomb
  96.                   InfoStation              032/001   Perry Alexander
  97.  
  98.         If  you are in  the GTPN  nodelist then you  will be  able to register
  99.         direct online at any of those centres  or via mail in the correct form
  100.         to OZRobot at any of those centres.  See the included OZRobot document
  101.         for details.  If  you are not in the  GTPN net you will need  to apply
  102.         via  private netmail  or  message  to Sysop  at  any of  the  centres.
  103.         Whatever  way  you do  it  you  will need  to  supply  the full  (case
  104.         sensitive) name to which you want the program registered.
  105.  
  106.  
  107.  
  108.  
  109.                                      >> page 2 <<
  110.  
  111.         SHOWUSER: v3.10                                   by Stephen de Plater
  112.         April 3, 1991                                         GT Network 302/1
  113.  
  114.  
  115.  
  116.         You will  also need to obtain the  OZINSTAL program which performs the
  117.         actual installation.  OZINSTAL  is not included in this  archive.  You
  118.         should look for OZINST11.ZIP.
  119.  
  120.  
  121.         ======================================================================
  122.         3.                              PURPOSE
  123.         ======================================================================
  124.  
  125.                          (Or what does this thing do anyway?)
  126.  
  127.         SHOWUSER is a  simple door which  displays the logons for  a specified
  128.         period.  It is designed to show who has logged on  and when during any
  129.         one day.
  130.  
  131.  
  132.         ======================================================================
  133.         4.                               USAGE
  134.         ======================================================================
  135.  
  136.         To use SHOWUSER simply create a door which runs the program.  The user
  137.         will then be presented with  the complete list of logons for  the day.
  138.         The date, time and username are shown for each logon.
  139.  
  140.  
  141.         A sample batch file for the door is shown below:
  142.  
  143.              --------------------------------------------------------------
  144.                   @echo off 
  145.                   gtdrwy 
  146.                   doorway SYS /W: /K:0 /B:MS /A:ON /T:^C^K^P /S:e:\bbs
  147.                             /O: /P:e:\bbs\showuser.exe
  148.              --------------------------------------------------------------
  149.  
  150.  
  151.         ======================================================================
  152.         5.                      COMMAND LINE PARAMETERS
  153.         ======================================================================
  154.  
  155.         For most users  this program requires no command  line parameters.  In
  156.         general the defaults are completely  adequate (which is the way  I use
  157.         it at  Kangaroo Korner).   However, for those  who need to,  there are
  158.         three command line parameters which can be adjusted.
  159.  
  160.  
  161.  
  162.  
  163.                                      >> page 3 <<
  164.  
  165.         SHOWUSER: v3.10                                   by Stephen de Plater
  166.         April 3, 1991                                         GT Network 302/1
  167.  
  168.  
  169.  
  170.         1.   /M   Force ANSI graphics OFF, no matter whether the user has them
  171.                   selected  or not.  The  default is  to  let users  who  have
  172.                   selected ANSI  graphics see the  display in color  and boxed
  173.                   with  IBM graphics characters.   If ANSI is  not selected by
  174.                   the user (or if this command line  switch is selected by the
  175.                   Sysop) the display will be in monochrome and only pure ASCII
  176.                   characters will be used for the boxes.
  177.  
  178.         2.   /C   The  opposite of  /M.   Forces ANSI  graphics ON,  no matter
  179.                   what.
  180.  
  181.         3.   /Lnn Log  scan amount in Kbytes (default 20).  SHOWUSER scans the
  182.                   end of the log for  details of what has happened today.   If
  183.                   your  system is EXTREMELY busy  you might need  to make this
  184.                   amount larger.  Alternatively  if your system is very  quiet
  185.                   then you might  get away with reducing  the amount somewhat.
  186.                   If you  reduce the amount  too much then some  calls will be
  187.                   missed because you won't  go back far  enough in the log  to
  188.                   get to  the beginning of the day.  The 20k default value has
  189.                   proved  more  than  adequate  for  the  busiest  systems  in
  190.                   Australia.  In any case, no matter how far you go back, only
  191.                   calls  which  have occurred  today will  be  shown.   And of
  192.                   course, the further you go back, the longer it will  take to
  193.                   scan the log.
  194.  
  195.         4.   /G   Specify  an alternate GTPATH.  Most users will not need this
  196.                   one.  It can be useful for systems running multiple nodes on
  197.                   a single machine under a multitasker.  If used, an alternate
  198.                   GTPATH follows the /G with no spaces (eg: /Gc:\altpath).
  199.  
  200.  
  201.         ======================================================================
  202.         6.                              COLORS
  203.         ======================================================================
  204.  
  205.         SHOWUSER will use the colors which GT is using.
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.                                      >> page 4 <<
  218.  
  219.         SHOWUSER: v3.10                                   by Stephen de Plater
  220.         April 3, 1991                                         GT Network 302/1
  221.  
  222.  
  223.  
  224.         ======================================================================
  225.         7.                            DISCLAIMER
  226.         ======================================================================
  227.  
  228.         Q:         What kind of guarantee comes with this software?
  229.  
  230.         A:                    *** ABSOLUTELY NONE!!! ***
  231.  
  232.         If you break it you get to keep both pieces!
  233.  
  234.         I take no responsibility  at all for what this software may  do on any
  235.         computer other than my own. If you use it you do so at your  own risk.
  236.         All that I am prepared to say about it is that it works fine here (and
  237.         I can see no good reason  why it should not also work fine  everywhere
  238.         else also -- but ....)
  239.  
  240.         By using this program you accept these conditions.
  241.  
  242.  
  243.         ======================================================================
  244.         8.                              ENJOY!
  245.         ======================================================================
  246.  
  247.         At least, I hope you do!
  248.         Stephen
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                      >> page 5 <<
  272.